home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / dclock15 / dclock.doc < prev    next >
Text File  |  1996-04-07  |  8KB  |  246 lines
  1.     DClock V1.5 - The ultimate, menu driven Workbench-Clock
  2.     =======================================================
  3.  
  4.  
  5.  
  6.     Introduction
  7.     ------------
  8.  
  9.     DClock is a digital clock program for the Amiga Workbench.
  10.     Features include:
  11.  
  12.     - DClock has it's own small window which can be placed
  13.       anywhere on the Workbench screen.
  14.  
  15.     - DClock  comes with a completely  menu-driven GUI. No
  16.       commandline options are necessary.
  17.  
  18.     - Timer and alarm clock function with the ability to
  19.       run user-defined Shell commands (including ARexx-
  20.       scripts if you use the RX command, and Shell-scripts
  21.       with the Execute command).
  22.  
  23.     - Date function
  24.  
  25.     - Fore- and  background colors of the window are user-
  26.       defineable.
  27.  
  28.     - All settings  can be saved and will automatically be
  29.       loaded upon startup. This  includes the  position of
  30.       the DClock window, the  colors, and  the settings of
  31.       the alarm clock.
  32.  
  33.  
  34.     Requirements and Installation
  35.     -----------------------------
  36.  
  37.     DClock makes use of the  reqtools.library, which is not part
  38.     of this distribution. It is  available  on Aminet or  on the
  39.     Amiga software library (fish) disks. Thanks to Nico Francois
  40.     for his great product.
  41.     You need Kickstart 2.04+ to be able to run DClock. If DClock
  42.     immediately  returns after startup, check  whether you  have
  43.  
  44.            Kickstart V37+
  45.            reqtools.library V38+
  46.            a public screen called 'Workbench'
  47.            enough free memory
  48.  
  49.  
  50.     Installation is very simple: Simply drag  the DClock icon to
  51.     the WBStartup drawer of your system partition/disk or to any
  52.     other drawer, if you don't want DClock to be started automa-
  53.     tically after booting.
  54.  
  55.  
  56.     DClock Menus
  57.     ------------
  58.  
  59.     While the DClock window is active, you can select the follo-
  60.     wing menu items:
  61.  
  62.     DClock menu:
  63.  
  64.        Seconds (toggle) : Display seconds on/off
  65.  
  66.        24H (toggle)     : Toggle between 24 hour mode or 12 hour
  67.                           AM/PM mode, and, if Date is on,
  68.                           between DD.MM.YYYY and MM.DD.YYYY
  69.  
  70.        Date (toggle)    : Turn date on/off
  71.  
  72.        Alarm on (toggle): Turn alarm function on/off
  73.  
  74.        Timer on (toggle): Turn timer function on/off
  75.  
  76.        Set alarm clock  : Set the alarm time
  77.  
  78.        Set timer        : Set the timer
  79.  
  80.        Alarm command    : Enter a Shell-command which will be
  81.                           executed when the alarm went off.
  82.                           RUN your command if if it takes longer
  83.                           and you don't want to block out the GUI.
  84.  
  85.        Timer command    : dito for the timer.
  86.  
  87.        Save Preferences : Save all the settings to
  88.                           ENVARC:DClock.prefs
  89.  
  90.        About...         : Information about DClock
  91.  
  92.        Quit             : Call the Terminator
  93.  
  94.     Window menu:
  95.  
  96.        Foreground Color : Set the foreground (text) color
  97.  
  98.        Background Color : Set the background color (who would
  99.                           have guessed...)
  100.  
  101.        Dragbar (toggle) : Turn the window dragbar and title on
  102.                           and off. The state of the checkmark
  103.                           will be saved in the preferences file.
  104.  
  105.        Activate (toggle): Activate DClock window after startup/
  106.                           reopen.
  107.  
  108.     When you select `Save Preferences'  from  the  Project menu, the
  109.     state  of the alarm  clock  will be saved, too. The  alarm  will
  110.     then be automatically turned on after startup (if it was on when
  111.     you saved  the prefs, off course). I e.g. set the  alarm to 1.00
  112.     AM, switched  it on and  selected `Save preferences'. I  now get
  113.     reminded every day that it's time to go to bed without having to
  114.     set the alarm again and again.
  115.  
  116.  
  117.     Legal section
  118.     -------------
  119.  
  120.     This program is Freely Distributable, as  opposed to Public
  121.     Domain.  Permission  is given  to  freely  distribute  this
  122.     program  provided  no  fee  is charged, and  this  documen-
  123.     tation  file  is included with the program. All  rights re-
  124.     served.
  125.  
  126.     (c) 1994 by Karl Lukas
  127.  
  128.  
  129.  
  130.     Info about the author
  131.     ---------------------
  132.  
  133.     Send bug reports, compliments and such to
  134.  
  135.        kalle@gis.geogr.unizh.ch
  136.  
  137.     Send postcards, money and other gifts to
  138.  
  139.        Karl Lukas
  140.        Konradstr. 51
  141.        CH-8005 Zuerich/Switzerland
  142.  
  143.     These addresses are valid until Feb. 1995. Send  snail mail
  144.     to
  145.  
  146.        Karl Lukas
  147.        Hinterzweienstr. 91
  148.        CH-4132 Muttenz
  149.  
  150.     after  this date. I don't  know if I'll have an email
  151.     account by then :(   (God, how can one live without?)
  152.  
  153.  
  154.     Send threatening letters, letter bombs a.s.o. to
  155.  
  156.        NIL:
  157.  
  158.  
  159.  
  160.     History
  161.     -------
  162.  
  163.     V1.0 Apr 1994 o Initial release
  164.  
  165.     V1.1 Jun 1994 o DClock now runs three independent tasks:
  166.                     - User interface  (DClock)
  167.                     - Updating of the DClock window, timer etc.
  168.                       (DClockTask)
  169.                     - display information when alarm went off or
  170.                       timer is finished (DClockInfo).
  171.                     Advantage: Clock and timer won't be stopped tem-
  172.                     porarily while a window/requester is open. You
  173.                     can get informed now when the timer/alarm went
  174.                     off while a window/requester is open.
  175.  
  176.                   o Bug: The alarm and timer symbols were drawn with
  177.                     incorrect offsets, so that the display got mes-
  178.                     sed if big screen fonts were used.
  179.  
  180.                   o The settings are now stored in ENVARC:DClock.prefs
  181.                     You can copy your old DClock.prefs file from S: to
  182.                     ENVARC: if you want to use your old settings.
  183.  
  184.     V1.2 Nov 1994 o You can now enter a Shell command, which will be
  185.                     executed when the alarm or the timer went off. The
  186.                     command can be saved to the preferences file. If you
  187.                     don't want to execute a command, just enter an empty
  188.                     string.
  189.  
  190.                   o The current time is now displayed with two digits
  191.                     in the alarm/timer requester (i.e. 18:08:12 instead
  192.                     of 18:8:12). Hey, there is an ANSI function for
  193.                     this. Why didn't anybody tell me?  ;)
  194.  
  195.                   o You can now turn the titlebar and dragbar off with
  196.                     the menu option "Dragbar". Off course you cannot move
  197.                     the window anymore when the dragbar is turned off.
  198.                     You can save the state of the "Dragbar" menu item to
  199.                     the preferences. THIS ONLY TAKES EFFECT WHEN YOU QUIT
  200.                     AND START DCLOCK AGAIN.
  201.  
  202.     V1.3 Nov 1994 o OK, the dragbar switching was not very elegant. Now
  203.                     you can turn the dragbar on and off without leaving
  204.                     the program.
  205.  
  206.                   o Got rid of the `Snapshot position' menu item. Now
  207.                     `Save preferences' saves the current position, too.
  208.  
  209.                   o I rearranged the menus to a somewhat more logical
  210.                     order.
  211.  
  212.                   o `Alarm command' and `Timer command' now use the
  213.                      SystemTagList() function. A console window is opened
  214.                      as stdin/stdout for the executed program, so you can
  215.                      actually _see_ it's output if you started DClock from
  216.                      the Workbench. Nice, isn't it?
  217.  
  218.     V1.4 Dec 1994 o 12 hour AM/PM mode added.
  219.  
  220.     V1.5 Dec 1994 o (I should actually be preparing for my exams... :)
  221.  
  222.                   o Little bug fixed: You could deadlock DClock by
  223.                     immediately quitting it after startup (this was
  224.                     only theoretical as you had no chance to immediately
  225.                     quit DClock because the window was not activated).
  226.  
  227.                   o OS3.0+ users now get white menus.
  228.  
  229.                   o Date function added. If the 24H mode is active,
  230.                     the date is displayed as DD.MM.YYYY. Otherwise day and
  231.                     month are swapped (i.e. MM.DD.YYYY). I hope this suits
  232.                     your needs.
  233.  
  234.                   o New menu item `Activate' added.
  235.  
  236.                   o New menu shortcuts added
  237.  
  238.  
  239.  
  240.     Commercial "DClock - The t-shirt"
  241.     ---------------------------------
  242.  
  243.     Just kidding ;)
  244.  
  245.  
  246.